home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / elk-2_0.lha / elk-2.0 / README < prev    next >
Text File  |  1992-11-02  |  3KB  |  72 lines
  1. This directory holds the source code and documentation for the latest
  2. release of Elk, the Extension Language Kit.
  3.  
  4. The file RELEASE explains the purpose and release status of Elk;
  5. COPYRIGHT and CONTRIBUTORS contain its copyright status and
  6. acknowledgements.
  7.  
  8. CHANGES summarizes the changes between this and earlier releases.
  9.  
  10. MIGRATE explains how extensions written for old versions of Elk may
  11. have to be modified (if necessary) so that they can be used with the
  12. most recent version of Elk.
  13.  
  14. INSTALL explains how to compile and install Elk on your system.
  15.  
  16. MACHINES gives additional, machine-specific information (such as
  17. compiler bugs, unsupported features, problems with older OS versions
  18. and other pitfalls) about installing and using Elk on the systems
  19. where it has been tested.
  20.  
  21. The directory "config" holds the configuration files containing
  22. machine- and site-specific information required for building Elk.
  23.  
  24. "include" holds the include files with definitions of objects exported
  25. by the interpreter.  These include files are used by all extensions.
  26.  
  27. "scripts" holds shell scripts used to link the interpreter with a
  28. number of extensions and to link individual extensions.  See README
  29. in this directory.
  30.  
  31. "src" holds the source files of the interpreter proper.
  32.  
  33. "scm" holds Scheme files that are loaded by the interpreter during
  34. runtime.  These files are copied to a destination directory when Elk
  35. is installed.
  36.  
  37. "lib" holds the source code of the Elk extensions.
  38.  
  39. lib/xlib and lib/xt contain the Xlib extension and the Xt extension
  40. (the parts of them that are written in C).  See examples/xlib for
  41. a few simple programs that demonstrate the Xlib extension to Elk.
  42.  
  43. lib/xaw and lib/xm contain the interfaces to the Athena and Motif
  44. widgets.  There is one .d-file for each widget class; these .d-files
  45. are compiled to .c-files by running "make".  See examples/xaw and
  46. examples/xm for demo programs that make use of the Athena and Motif
  47. extensions to Elk.
  48.  
  49. lib/util holds the source code for a small library of utility functions
  50. that are used by all extensions.
  51.  
  52. lib/misc holds a number of small extensions that mainly serve as
  53. demonstrations, among them a GNU "gdbm" extension.
  54.  
  55. "doc" holds the documentation for Elk.  All documents come both as
  56. troff input and as preformatted PostScript files.  See doc/README for
  57. an overview of the available documentation.
  58.  
  59. "examples" holds a number of simple demo programs.  The programs in
  60. examples/scheme have been collected from various sources (among them
  61. USENET and the Scheme mailing list).
  62.  
  63. "util" holds a few test programs that may serve helpful in preparing
  64. a configuration file for an as yet unsupported type of system, and
  65. other programs that are only required on certain exotic systems.
  66. See README in this directory.
  67.  
  68. "contrib" holds a collection of extensions that have been contributed
  69. by users of Elk.  I haven't tested most of the things in this directory;
  70. I don't even know if all of them are usable with the current release of
  71. Elk.
  72.